Chapter 4-8: Runtime Subroutine's and Predefined Processes

.UTIL TIMEOUT EXIT

This subroutine exits the current process or logs a user off after a set timeout period.

Usage:

Description:

This subroutine exits the current process or logs a user off after a set timeout period. The <action> parameter is required, and the subroutine will CANCEL if it is not PASSed. The <action_delay> parameter is optional.

This subroutine should only be called in the Option Intercept or Global Option Intercept event points. You must have set a keyboard timeout via .UTIL TIMEOUT SET first, otherwise this routine does nothing.

<action> is the action that should be performed if a TIMEOUT has occurred (Required). It must be one of End or Logout. If it is End and the timeout has occurred, the current process will END. If it is Logout and the timeout has occurred, then the user will be logged out.

You may want to use Logout on Menus, and End on input processes. Thus, an unattended session at an Input process will first return to the menu, then log the user off.

<action_delay> is an optional parameter that represents the number of minutes before the action is taken. If this parameter is PASSed, then a message will be displayed to the user advising them how much time is left before the program exits. If there is no further activity, then the <action> will be taken when <action_delay> minutes has expired.

Note: If you use <action_delay> then:

After the warning, the <action_delay> becomes the new timeout.
The warning only appears once. If the user does something to reset the timer after the warning has appeared, the next time the timer expires the specified <action> will be taken immediately.

Application Design Manual                                         "Powered by Appx Software"

1190

©2006 By APPX Software, Inc. All Rights Reserved